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4.6.1.5 User Interface 



The ACT Manager's user interface (UI) will consist of HTML (HyperText Markup Language) pages which 
will be viewed through the ACT's Web browser or workstation web browser. The main browser page will 
consist of at least two frames, one of which will be a menu to allow the administrator to select a set of 
preferences to view or work on. The main frame will be a work area and will include an HTML form; this 
will contain the UI controls which will show the current preference settings and allow the administrator to 
make changes. An example appears below to illustrate how this could look; in the example, the user has 
just clicked on the XS2S0 icon in the Set Up Tasks frame. 




Sign-on 



Set Up Tasks 



. Temriiials 



X5250 



Back to 
wekome 



X5250 Fl-eferences 



On which set of defaults do you want to work? 



0 System defaults 

Set preferences for all users 



Defaults for user: 



Set preferences for a selected user *- 
O Create defaults for a newusen [ 



We will use JavaScript functions to enhance the behavior of the forms in the UI. JavaScript will allow us to 
write event handling functions to perform routine data validation on the form prior to submitting it to a CGI 
(Conunon Gateway Interface) program running on the server--a performance and usability enhancement. 
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Specific online help will be provided for each form; a separate help window will open when the user 
requests help by pushing the help button on the form. 



4.6.1.5 ACT Utilities Interface 

The ACT Utilities component is new for the ACT. The ACT Manager will send messages to ACT Utilities 
as part of the preference update process. The ACT Utilities will be listening on a well-known port that is 
listed in etc/services on the AS/400. A socket will be used to communicate with ACT Utilities. 
Changes for a particular user or terminal preference may be made by an administrator located on his own 
terminal. The ACT Manager needs to locate the terminal where the new preference should be applied. 
The ACT Manager will use the following methods to locate the target ACT terminal: 

• The ACT Manager needs to lookup the terminal IP address given a terminal host name. When a new 
terminal boots the bootp daemon will update etc/hosts. The ACT Manager will then use 

gethostbynameO to lookup the terminal. The ACT Manager also needs to know which devices are 
ACT terminals. The load_type field in the bootptab file will be read to filter out non-ACT devices. 

• The ACT Manager needs to lookup the terminal IP address given the name of a user. This will tell 
the ACT Manager on which terminal a user is logged-on. When a user logs on to the terminal the 
Logon program will write his IP address and hostname to a file in the user's directory. The ACT 
Manager will read this file and attempt to contact the device(s) listed. The Logon program will add 
and remove entries to these files as users logon and logoff. (Note, we may use the security object, 
not a file...TBD). 

A messaging interface needs to be defined between the ACT Manager and ACT Utilities. Shown below is 
the current list of messages sent to ACT Utilities. 

Tell ACT Utilities to reboot the terminal. ACT Utilities waits num_sec, displays the reboot message and 
then reboots the terminal. 



Field Name 


Field Value 


Command ID 


REBOOT 


Configd Password 


String act_mgr_configd_pw 


Reboot Type 


RESET^TERM 


Reboot Timing 


int num_sec /* 0 reboot now */ 

/* >0 reboot after time delay */ 
/* -1 reboot at next logoff */ 


Reboot Message 


String message__text 


Tell ACT Utilities that a user preference file has changed for a particular application. The ACT Utilities 
uses the target UserlD to verify the user is still logged-on. The ACT Utilities uses the client app name to 
locate the X Server files to xrdb -load. The ACT Utilities will reload the X Server files in the normal order 
(ie. control, then system, then user). 


Field Name 


Field Value 


Conmiand ID 


USER_PREF_AVAILABLE 


Configd Password 


String act_mgr_configd_pw 


Target User ID 


String user_id /* NULL = cuixent user */ 


Client_App 


String client_app„name 


Application Timing 


int num_sec /* 0 apply changes now */ 
/* >0 apply after delay */ 
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/* -1 apply at next logoff */ 



Tell ACT Utilities to display a Pop-up informational message sent by an administrator: 



Field Name 


Field Value 


Command ID 


DISPLAY_MESSAGE 


Configd Password 


String act_mgr_configd_pw 


Target User ID 


String user_id /* NULL = current user */ 


Message 


String message_text 


Query ACT Utilities for the current logged-on UserlD and password. This is used by the ACT Manager 
CGI to learn which user is talking to it through the browser. 


Field Name 


Field Value 


Command ID 


GET^CURRENT.USER 


Configd Password 


String act_nigr_configd_pw 


Reply from ACT Utilities containing current UserlD: 


Field Name 


Field Value 


Conmiand ED 


REPLY_CURRENT_USER 


UserlD 


String user_id 


Password 


String password 




